Dialog::ShowAt

Section: ET++ method description (n)
Updated: automatically Fri Mar 15 14:08:59 1991
Index Return to Main Contents

NAME

Dialog::ShowAt - instance method

TEMPLATE

actionId = int ShowAt(VObject * father, Point position)

SPECIFIERS

public virtual

DESCRIPTION

ShowAt updates the window layout, if necessary, sets up the dialog items and opens the dialog window in front of the window of father at position. Depending on whether the dialog window is modeless or modefull ShowAt either immediately returns or blocks until an ActionButton has been selected. In the first case the actionId has no meaning and the button ids should then be checked by overriding the method Control. Method is never overridden.

ARGUMENTS

VObject * father: the dialog is opened over the window that contains father
Known Problems: If the dialog is modefull and the used window system is SunView, then father must not be NULL, otherwise a fatal error is reported and the application aborts.
Point position: contains the position where the dialog is opened (with respect to its upper left corner). The position is additionally modified by the method GetInitialPos. The resulting coordinates are interpreted relative to the origin of the window that contains father. If father is NULL they are used as absolute screen coordinates.

RETURN ARGUMENT

int actionId: If the dialog window is modefull, then actionId is the id of the ActionButton that caused the dialog window to be closed and is then also contained in the instvar actionId.
If the dialog window is modeless, then ShowAt immediately returns and the actionId contains a random value.

FIRST DEFINITION

class Dialog

FILES

implementation:: Dialog.C

KNOWN PROBLEMS

Due to the problem of the father argument under SunView it is recommended that ShowAt is never called directly but only via the method Show and the method ShowOnWindow. These methods make sure that father is always set.

This document was created by man2html, using the manual pages.
Time: 00:40:29 GMT, March 30, 2022